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Subject! estimat e_bi I I command. 

A new command, est imate_bi I I , is proposed to enaole users to 
obtain information about resources consumed during a session and 
their cost. A draft HPM writeup is included. 

It will be necessary to extend the Process Initialization 
Table (PIT! to induce the total memory units and terminal I/O 
operations for previous processes in the current session, as well 
as the total virtual CPU time* which is already included. This 
will be needed for any application in which figures for 
resource consumption in the current session are desired, as well 
as for implementation of the estima te^bi 1 1 command. It will 
then be possible to obtain the usage for previous processes from 
the PIT, and the usage for the current process can be obtained 
from the supervisor. 

tiaufi t est imate_bi I I , eb 

The est inat e_bi 1 1 command prints a report about the CPU time, 
memory usage, terminal I/O, and connect time for the current 
console session and their cost. Arguments allow the user to 
specify various parts of the available information to be printed, 
or to specify that initialization is to be performed. 

Although Multics Keeps very accurate records of the total 
resources that a user has consumed on each shift curing the 
current month, a breakaown by shifts of usage for the current 
session is not Kept. It is therefore necessary to record 
information about usage on different shifts if a shift change has 
occurred during the current session, and accurate cost figures 
are desired. This information will be recorded at the time the 
shift changes if the est imate_bi I I command (with any argument) 
has been given during the current process. The purpose of the 
argument w -init H is to set a timer for the next shift change, 
without producing output, so that the usage for the shift that 
enos at that time can be recorded. If usage information is 
recorded, a segment will be created for this purpose in the 
user's login directory. It will have the name username. eb_dat a, 
where username is the user's login name, ana Hi I I be created only 
if the shift changes. 

If the information requested cannot be computed accurately, 
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i.e. a shift change has occurred during the session and the usage 
for that shift Has not recorded because the user dici not set up 
the est i mat e__bi 1 1 command to do so, the breakdown by shift will 
be estimated. The first time est imat e_bi i i is invoked after a 
shift change at which usage was not recorded, the missing values 
will be estimated by assuming that the amounts of CPU time, 
memory usage, and terminal I/O per unit of real time are constant 
for the whole session. The estimates for past shifts will then 
be recorded and used in future invocations of est imate_bi 1 1 . 



est i mat e_bi I I -contro l_arg- 



1> - contro I _arg- 



- init 



- long, - Ig 



Provides the ability to select various 
portions of the available information to be 
printed, or to initialize the command. 

This argument initializes the command for a 
process. A timer is set to go off next time 
a shift change occurs. When this timer goes 
off, the usage for the shift that ends at 
that time will oe recorded, as described 
above. Any use of the est imate_bi I J command 
will set this timer? the -init argument 
suppresses the printing of information. If a 
user is interested in obtaining accurate 
usage values for a session that may include a 
shift change, this command should be given at 
the beginning of each process in the session, 
or be included in the user's start up 
exec_com. 

Prints the most detailed information about 
the resources used during the current 
session. The display includes a report of the 
total virtual CPU time, memory usage, 
terminal I/O operations, and costs, broken 
down by shift. 



-brief, -bf 



Prints only the total cost of 
sess ion. 



the current 



If no argument is given, the dollar cost of the current 
session is printed, broken down by shift. If usage has to be 
estimated, this fact will be indicated. 



If the esti mat e_bi I I command is given during an absentee 
session, the output will be placed in the output segment. For 
absentee processes, shifts have no significance, ana giving the 
command "es t imate_b i 1 1 -init" will have no effect. 



